postcss-zindex
Advanced tools
The postcss-zindex package is a PostCSS plugin that reduces z-index values in your CSS files. It helps to minimize the number of different z-index values used, making your CSS more maintainable and reducing the risk of z-index conflicts.
Reduce z-index values
This feature reduces the z-index values in your CSS to a smaller range, making it easier to manage and reducing the likelihood of conflicts.
/* Input CSS */
body {
z-index: 10;
}
.header {
z-index: 100;
}
.footer {
z-index: 1000;
}
/* Output CSS after postcss-zindex */
body {
z-index: 1;
}
.header {
z-index: 2;
}
.footer {
z-index: 3;
}The postcss-sorting package sorts CSS rules content with specified order. While it doesn't specifically target z-index values, it helps in organizing CSS properties, which can indirectly help in managing z-index values by keeping the CSS more structured.
The postcss-merge-rules package merges adjacent CSS rules with identical selectors. This can help reduce redundancy in your CSS, similar to how postcss-zindex reduces the number of z-index values. However, it focuses on merging rules rather than specifically targeting z-index values.
The postcss-combine-duplicated-selectors package combines duplicated CSS selectors into one. This helps in reducing the size of the CSS and making it more maintainable, similar to how postcss-zindex reduces z-index values. However, it focuses on combining selectors rather than z-index values.
Reduce z-index values with PostCSS.
With npm do:
npm install postcss-zindex --save
Sometimes, you may introduce z-index values into your CSS that are larger than
necessary, in order to improve your understanding of how each stack relates to
the others. For example, you might have a modal overlay at 5000 and the dialog
for it at 5500 - so that modal classes occupy the 5xxx space.
But in production, it is unnecessary to use such large values for z-index where
smaller values would suffice. This module will reduce all z-index declarations
whilst respecting your original intent; such that the overlay becomes 1 and
the dialog becomes 2. For more examples, see the tests.
.modal {
z-index: 5000
}
.modal-overlay {
z-index: 5500
}
.modal {
z-index: 1
}
.modal-overlay {
z-index: 2
}
Note that this module does not attempt to normalize relative z-index values,
such as -1. Be careful with using this module alongside JavaScript injected
CSS; ideally you should have already extracted all of your stacking context
into CSS.
See the PostCSS documentation for examples for your environment.
Pull requests are welcome. If you add functionality, then please add unit tests to cover it.
MIT © Ben Briggs
FAQs
Reduce z-index values with PostCSS.
The npm package postcss-zindex receives a total of 926,964 weekly downloads. As such, postcss-zindex popularity was classified as popular.
We found that postcss-zindex demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 7 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
North Korean threat actors deploy 67 malicious npm packages using the newly discovered XORIndex malware loader.
Security News
Meet Socket at Black Hat & DEF CON 2025 for 1:1s, insider security talks at Allegiant Stadium, and a private dinner with top minds in software supply chain security.
Security News
CAI is a new open source AI framework that automates penetration testing tasks like scanning and exploitation up to 3,600× faster than humans.